
  HelpChat Server 12 升级到 13 步骤
======================================

  HelpChat Server 13 支持 Windows Server 2008 至 2025，为确保最佳性能，
  建议使用 Windows Server 2016 或以上版本。

  ⚠ 升级前请先停止 Server 12，并备份整个 HelpChat Server 12 目录。

  以下步骤假设：

    12 服务端目录：C:\HelpChat Server 12\
    13 服务端目录：C:\HelpChat Server 13\

  请根据你的实际安装路径替换。


一、迁移聊天的 文件、云盘 数据
--------------------------------------
  将 12 的数据目录复制到 13：

    源：  C:\HelpChat Server 12\imdata\ 下的 data 子目录
    目标：C:\HelpChat Server 13\imdata\ 复制到此目录


二、迁移头像文件
--------------------------------------
  将 12 的头像目录复制到 13：

    源：  C:\HelpChat Server 12\public\ 下的 groups 和 users 子目录
    目标：C:\HelpChat Server 13\public\ 复制到此目录

  或者 12 的早期版本是以下目录：

    源：  C:\HelpChat Server 12\imdata\ 下的 group 和 user 子目录
    目标：C:\HelpChat Server 13\public\ 复制到此目录
	
	
三、修复头像文件扩展名
--------------------------------------
  版本 12 头像文件没有扩展名，版本 13 要求 .png 扩展名。

  双击运行以下两个目录中 add_png_ext.bat 文件：

    C:\HelpChat Server 13\public\groups\
    C:\HelpChat Server 13\public\users\

  脚本会自动为无扩展名的文件添加 .png，已有 .png 的不受影响。


四、迁移服务器 ID
--------------------------------------
  打开 12 的配置：C:\HelpChat Server 12\config\serverid.dat
  填入 13 的配置：C:\HelpChat Server 13\config\helpchatsvr.ini

  对应关系：

    serverid.dat          helpchatsvr.ini [server]
    ──────────────        ──────────────────────
    id=xxx            →   id_office  = xxx
    idex=xxx          →   id_market  = xxx

  ⚠ 服务器 ID 必须与 12 一致，否则客户端无法识别服务器。


五、迁移数据库配置
--------------------------------------
  打开 12 的配置：C:\HelpChat Server 12\config\mysql.ini
  填入 13 的配置：C:\HelpChat Server 13\config\helpchatsvr.ini

  对应关系：

    mysql.ini             helpchatsvr.ini [database]
    ──────────────        ──────────────────────
    host=xxx          →   host       = xxx
    port=xxx          →   port       = xxx
    user=xxx          →   user       = xxx
    pswd=xxx          →   password   = xxx
    db=xxx            →   db_office  = xxx
    dbex=xxx          →   db_market  = xxx
    charset=xxx       →   charset    = xxx
    runmode=xxx       →   run_mode       = xxx  （在 [runtime] 段）
    threads=xxx       →   worker_threads = xxx  （在 [runtime] 段）

  ⚠ 注意将 [database] 段的 type 从 sqlite 改为 mysql。


六、启动验证
--------------------------------------
  1. 启动 HelpChat Server 13
  2. 客户端登录，确认账号和历史消息正常
  3. 确认群组和用户头像显示正常


注意事项
--------------------------------------
  · 13 会将数据库中所有名为 order 的字段重命名为 rorder，此变更不可逆，
    12 将无法再读取被 13 升级过的数据表。请务必在升级前备份 12 的数据库。

  · 13 使用的端口与 12 相同，启动 13 前务必确认 12 的 HelpChat Server 服务已完全停止，
    否则会出现端口冲突导致启动失败。

  · 如果 13 继续使用 12 的 MySQL 数据库，停止 12 的 HelpChat Server 服务时，
    请确保 MySQL 服务保持运行中。


建议
--------------------------------------
  · 如果是全新部署，建议安装 MySQL 8.0 或 MariaDB 10.6+ 作为数据库，
    相比 12 中默认的 MySQL 5.7，性能和稳定性都有显著提升。
    
  · 如果在线人数在 50 人左右，可以直接使用 SQLite，无需安装任何数据库，
    开箱即用，零配置。
